bitkeeper revision 1.337 (3f0d657f74Gik-j1dECKz392l6y-UQ)

USAGE-cmdline:
  Add important message about not using the web interface at the same time as the command line

diff --git a/tools/control/doc/USAGE-cmdline b/tools/control/doc/USAGE-cmdline
index 1e4766b80f0a335f958afe73ea63bae99ae0bddf..189577987dcfadc3fb9f40862799b445cc66abca 100644 (file)
--- a/tools/control/doc/USAGE-cmdline
+++ b/tools/control/doc/USAGE-cmdline
@@ -1,3 +1,22 @@
+IMPORTANT! DATA LOSS POTENTIAL!
+-------------------------------
+
+It is important that no changes be made to the virtual disk manager through
+the command line while the web interface is running!
+
+If you use the web interface at all, it is NOT safe to call:
+xenctl partitions add
+xenctl vd create
+xenctl vd delete
+xenctl vd refresh
+
+Your changes will likely be lost, or the virtual disks left in an
+inconsistent state, or data on them corrupted or erased.
+
+Other xenctl functions do not modify VDM state and are therefore safe,
+e.g. it's okay to do domain control from the command line if the web
+interface is running.
+
 General
 -------
 
@@ -74,4 +93,4 @@ Create a virtual block device:
 Lists virtual block devices:
   xenctl vbd show
   
-Virtual block devices are automatically deleted when their domain is destroyed.
\ No newline at end of file
+Virtual block devices are automatically deleted when their domain is destroyed.